Whiteline: delta

home *** CD-ROM | disk | FTP | other *** search

/ Whiteline: delta / whiteline CD Series - delta.iso / classics / tools / paula / doc / papyrus / paula_e.pap (.txt) < prev

Wrap

Papyrus | 1995-11-25 | 51.1 KB | 2,533 lines

ATARI PICA 10 dpi Swiss 721 Freehand 471 Monospace 821 More Wingbats SWC Freehand 591PARA Swiss 721 DIN A4 Standard Leerzeile berschrift Kommentar Liste_1 Liste_2 Liste_3 Listing *Kapitel UMSCHLAG Paula MOD-File Player Paula MOD-File Player PAULA (Paula, two!) Amiga-MODfile-Player Atari Version 415.9.1994 3Shareware Pascal Fellerich handbook written using' @Papyrus R.O.M. Software Shareware Starting version Paula shareware. means distribute software freely. regularly register. beginning Paula little utility modfiles which wrote *weeks. reactions little piece software positive, decided rewrite player completely which possible integrate tures. Paula become powerful program which equivalent until Anow. decided release shareware. You'll details paragraph" 'Registration Procedure'. following files 'PAULA'-package remain unchanged% distributed together: PAULA.APP program (alternative names LA.ACC PAULA.PRG)/ PAULA_D.TXT german manual. PAULA_E.TXT english manual MP.TTP ModPlay: little utility modules JCLI's./ source ModPlay7 MP.PRJ Project-File Pure-C CHECKMOD.TTP Checks module repairs corrupted- 7modfiles possible. version PAULA needs 'PAULA.INF' given *away contains registration data. course modifications these files forbidden! Paula distributed 'Public \main' disks; however shareware status software affected!0 rights reserved Fellerich.. Contact address: Pascal Fellerich L-3482 Dudelange (Luxembourg) E-Mail: 2:270/16.3 (Fido-Net)) fellerich@fido.lu (Internet) versions possibly versions reenable blocked features.0 Registration procedure Paula shareware. means larly. versions needed enable features, ecould obtain paying registration version similar restrictions. prevent excessive illegal program it's0 decide register, please address (legible, please)> Name: <first name> <name> chars maximum) <street> chars maximum) City: <city> chars maximum) shareware remark Paula. avoid )plications accept money (BEF/LUF, %I'll personal Paula which needed older cperhaps newer releases. questions and/or suggestions Paula? Paula plays so-called 'modfiles' using STE/TT sound chip. These modfiles, called 'modules', originate Amiga which special four-. Kchannel soundchip called 'Paula'. Paula doesn claim fastest modplayer available Atari, unique combination perfect interface highly sophi( ?sticated sound processing unit. What Paula? avoid rather lengthy description, short Paula's features: Compatible really MOD-formats, ranging Soundt4 racker format Protracker format. Three sampling frequencies available: 12.5, (when using @Paula little sound- driver 'PETRA' KHz). Linear interpolation option giving great improvement sound quality.9 Booster option, rising ratio Completely independent pitch speed tuning./ Supports packed modules. consequently TOS-machine. cludes Atari's MultiTOS, Magix Simple intuitive control Supports extended selection features Selectric Gemini0 Programmable simple player3 Random: random several modules. Repeat-switch: module whole selection repeated ^finitely) position display began... When wanted sound chip. downloaded Cmodplayers tried them. Unfortunately crashed, those which 68030 produced 'lo-fi' fidelity) sound. write player easier acquire >ledge 'real' PAULA-chip Amiga course STE/TT sound Mhardware simply because wanted replay routine Amiga (D.O.C. replayroutine 1986). weeks later Paula $running'. release still buggy limited capacities finally worked !fine After several optimizations improvements concluded glopment v1.5. april discussion fidonet re-ignited global interest [module player, decided continue development. versions released. meantime, sound quality greatly enhanced {still interface lousy. rewrote whole thing that's it... System requirements Paula machine TOS-compatible operating system, starting STE-compatible sound hardware sound driver PETRA %However, faster machines allow decent background Paula; bstock running won't sampling frequency. MegaSTE fine, better. Paula without sound PETRA sound driver Paula Christian Limpach. Installation Paula accessory application. normal versions accessory useful, under MultiTOS better 2program. course Chameleon' other accessory" loader) ACC.. Under MultiTOS Magix Paula background task, close window without leaving program! Another useful thing XCONTROL should installed 'SOUND' vmodule change volume, treble, balance. Moreover should connect computer stereo equipment jacks) possible sound. User's Guide After launched Paula window containing dialog.- }This subdivided areas:, line% Player Sound Setup SampleFreq Position& player's control control These controls hopefully simplest. carry commonly symbols cassette recorder, should familiar 1those. every marked little letter upper corner tthat's keyboard shortcut. Press file. LOAD: First module. click LOAD-button selector order select module. Paula immedia )tely loads module. operation successful window 0will 'Stopped: <modfilename>'. error occurred infor standard alert installed 'Selectric selector, specify module! STOP: Well, stops module resets player. clears (Paula's memory selected several modules Paula forget dthem. shows 'Stopped: ...'. accessory mode, closing window stopped state releases memory allocated loaded module. PLAY: Starts player. haven't selected module Paula Cprompt press 'PLAY' Paula playing several modules module. (Skip function). PAUSE: Stops player temporarily. player reset! state accessory (close window) without losing Rrent module. continue, press PAUSE PLAY. (REWIND) Jumps previous position module. function works Paula 'playing' 'paused' state. (FAST FORWARD) Jumps position module. func6 works play- pause-mode. (Exclamation sign) Invokes SETUP-dialog which offers more1 Afunctions pitch speed tuning. (Question mark) general informations about Paula. Through Adialog registration dialog. register described9 xsome pages later (title: Registration procedure) familiarize yourself these commands simply trying Vtever succeed crashing Paula machines Omemory protection. Paula window display current status 6title currently loaded module. Currently states defined: Inactive Paula nothing. loaded memory cated. change resolutions Paula should preferably? avoid memory system crashes. Stopped Paula loaded module. change resolution allocated memory because didn't Paula! chance release Paused Paula waiting continue. buttons work. Playing Paula don't that? another program acces sound hardware Paula stopped, course. rsoon soundchip freed Paula tries continue, fwhich second. should reported. However manually relaunch player pressing PAUSE-button twice. SampleFreq choose sampling frequency Paula. Currently there three possibilities: 12.5, higher sampling frequency frequency response. Theoretically highest sound frequency value sampling frequency Shannon's sampling theorem). Atari hardware about sampling frequency. using samplefreq. sound frequency. Changes sampling frequency immediately effective. During Eswitching sound muted short moment avoid chirping click noises. Player Sound Setup types switches: switches influence sound synthesizer/ switches change replay modes Interpolate: Enables realtime interpolation samples. gives 2much better sound quality requires power. Ybecause 68030 multiplication shift faster 68000 0CPU. applies 68020 board instal STE... Booster: Increases output signal using little trick. impro signal noise ratio introduces certain amount distorsions, ,especially playing high-level signals. these distorsions mainly Jsecond order shouldn sound awful. Protracker: Enables protracker compatibility. general, sound modules upwards compatible player should correctly module, unfortunately protracker introduced features which critical. possibility switch protracker commands. |However, 15-instrument modules played protracker-mode disabled,+ :regardless switch position. Repeat: switch meanings, depending modules selected. selected single module, module repeated, whole bunch modules repeated. there modules (which 'jump' commands build endless loop. Paula recognizes these \interrupts them. Random: random function. selected several Eles, played random order every module time! After module played, Paula stops restarts whole process, depending 'Repeat' switch. CPU-Load display This bargraph shows amount Paula needs sound synthe psis. relative display, always total time, matter scessor have. Landmark Norton that's simply informative enough. right bargraph there little which flashes5 \every machine enough. Position This display shows current position module. using hexadecimal7 format know, programmers General instructions commands mainly intuitive should there special functions which evident. These leaving dialog9 selecting multiple modules ('multiplay mode') command logic hidden features %When close window Paula accessory, player 6tinue. Moreover close window simply pressing <Return> XCONTROL.ACC. Paula program, closing window terminate (gram player course stopped. can't pressing <Return> click closer-gadget window. Multiple choice... simplest select module Jwildcards. Instead selecting selector simply choose right specification, 'A*.MOD'. would module whose hname starts simply modules played which directory, simply select directory don't enter name. Paula then automatically select which matches '*.MOD'. ...using Selectric: 'Selectric selector select multi files (shift-key mouse click), Paula them. You'll details lectric-manual. ...with Desktop, Gemini, Install PAULA application files 'MOD'. Paula evaluate command also5 funderstand VA_START MP_START) messages. words about command logic: Paula always tries @current mode. module running another newly loaded (module immediately played. Paula stopped select multiple Xdules, 'pause'-mode. because Paula #will forget everything enters 'Stopped' mode. suggest )these commands familiarize yourself Extras: Paula prepared multitasking environments. means:? Paula evaluates command line. Paula understands VA_START (MP_...) messages. Paula identifies already running copies itself passes Wmand running copy, there's instance 8program running Setup-Page dialog dialog called '!'-command. offers features Qmanipulate sound 'save'- function. Pitch (cent): tuning function. tone, (fine-)detune Paula tone. standard tuning corre 'sponds 'NTSC'-Amiga 7.15909 clock frequency. 'PAL'- Amiga tuning, pitch bender -10..-15 cent. steps cent, finer }step needed human already problems detect detuning accessory version: Paula installed often accessory.0 cent.. Transpose: coarse tuning function. changes tuning 7steps, maximum tones which corresponds octave. Frame Speed: 'ticker' speed speed reference Amiga VBlank interrupt, standard setting aPaula allows value double speed (25..100 Save: Saves current setup 'PAULA.INF' leaves Olog. settings saved, dialog settings regist ration data. Exit: Leaves dialog without changing anything. However changes :have undone. Reset: Resets three settings (Pitch fine/coarse, Speed) leaves xlog. Info dialog: unavoidable box... remind sometimes mfact still using unregistered copy! Packed modules! Paula supports packed modules. packed modules LHARC higher! Suppose modules gathe directory C:\MODFILES getting full. launch OLHARC.TTP enter commandline: C:\MODFILES\*.MOD LHARC 5program modules, reducing approximatively their original size. Paula difference between packed *packed modules, completely transparent user. Error messages Paula normally reports errors using standard alert boxes. avoid problems ]unwanted alert boxes popping Paula won't complain about problems ?main window closed. Let's assume selected modules, A.MOD, B.MOD C.MOD; random emode Paula starts playing A.MOD, close window. After finishing Cwith A.MOD, Paula tries B.MOD. succeed Paula further activities 'Inactive' state. invoke Paula select 'LOAD', module which caused error. message 'Corrupted MODfile' means selected module cannot played. utility 'CHECKMOD.TTP' which analyzes ~module repairs possible. More informations module contains different samples which called 'instruments'. given sample different pitches Amiga simply varies replay #pling frequency. higher sampling frequency higher note. PAmiga independent sound channels, having conver different samples simultaneously without Atari channels (stereo which independent vfour fixed sampling rates. another trick simulate Amiga 'direct digital synthesis', 'resampling' process widely called. difficult understand: sample replayed where floating point number. sample Bspeed every sample output twice. !it's original speed, output twice, second output ,once Unfortunately sampling output irregularly which gives distorted sound. There eliminating these distorsions. Either rather (this would require large samples originally sampled gvery rate) interpolate output data. thing would spline inter Vpolation unfortunately requires matrix operations, Paula simple nlinear interpolation. Don't confuse 'oversampling' other module lplayers double output sound hardware sampling frequency. resulting sound quality sampling better Mthan Amiga! TT/STE filter which frequencies. Amiga switches filter produ trebles aliasing components. doubt about Amiga, listen about facts Hardware Reference Manual *[2]. However Amiga larger dynamic range volume registers ]which introduce another dynamic thing "signal-to-noise ratio which always systems (theoretically course; Isome systems disturbed present computer). conver uters Amiga sometimes called 'floating point converters'. order Qcope Paula 'Boost' option. option simply simulates bconverter using nonlinear conversion scheme. result volume -MODs introduces additional distorsion output levels. don't about interpolation routine works, following paragraph. routine.< Fix-Point number, representing replay typedef struct integer (1/1) fractional (1/65536) fixpoint Fetch sample calculate correct in-between value.9 Param pointer sample index: index inside sample fixpoint number9 volume: Amiga- Volumeregister value, 0..64+ Return: resulting sample value. Bereich sample volume info) samplevalue fixpoint index, volume s1,s2; sample values volume [index. volume [index. +1];5 return (((s2-s1)*index. )/65536 Besides routine index incremented (addition point Unumbers), return value scaled saved, sample =checked reached there channels which calcu 0lated above routine called 200,000 times second. etime optimizations done. 68030 would totally Ioverworked these routines really written (that means: better compiler...). really chapter: LIMITATIONS! Collisions: Normally Paula should interfere other program aproblems other utilities accessing sound hardware unavoidable. [long 'opponent' programmed nothing happen except Paula stopped other program sound chip. simple test: Paulas... can!) Overload: computer totally overloaded internal timing 4mewhat confused. consequence moment Paula writes @sound registers undetermined. happen sound starts playing wrong however registers contain right values! case, choose lower sampling frequency switch interpolation. Xgotten 68030 cache?? Resolution change: Before change resolutions Paula -inactive. Paula, press 'STOP' leave Paula again. Under MultiTOS might solved sends AP_TERM message every application Rbecause tells Paula activities. Protracker 'CIA'-replay-speed: version speed setup works exactly original. disadvantage Noisetracker modules played incorrectly; switch protracker "play modules. System crash STE's: 1040STE computers which Paula fdoesn't symptoms: computer freezes, escape being reset kbutton. likely hardware problem there absolutely 0tween crashes modules played .Similar symptoms experienced 1040STE 16MHz processor crashed cache problem. <have sorry, remedy, hardware version opcode removed, chance being Paula increases omewhat these machines... Internals GEM-message interface: Paula responds 'VA_START'-message (introdu Gemini). message contains pointer msg[3] msg[4]) which !evaluated Paula: pointer Pointer empty string: reaction rAC_OPEN Pointer string filename: Paula tries file. Pointer string multiple filenames: Paula multiplay+ zmode plays these files. string copied internally Paula, local writer's side. However memory readable beware MultiTOS memory protec ^tion!!! string contain complete indications, <CARDS. source (ModPlay) serve example.7 version there messages: MP_ACK (0x4800): Paula previous command under istood.msg[7] contains version number program; 0x204 Kv2.4 MP_NAK (0x4801): Paula previous command wasn't 1understood rejected. msg[7] contains version number program. MP_START (0x4802): works identical VA_START, after having Jtaken command string Paula replies MP_ACK WMP_NAK message, signalling memory string other purposes. important multitasking msystems. MP_STOP (0x4803): stops Paula releases memory. stays open. Paula replies MP_ACK. MP_SHUTDOWN (0x4804): Stops terminates Paula. accessory 5mode memory released window closed. Vector stealing... Paula interrupt 68901-MFP. course m'XBRA' protocol used, magic 'PAUL'. Memory usage: Paula needs program data. machines 68000 processor another volume tables. Emergency stop: Paula? Well, don't forget MP_SHUT? PDOWN message #0x4804) before doing Speeeeed! Paula should loaded FastRAM processor cache should enabled. Without cache Paula probably problems doing interpolation... schwartz Hardware: Timer wonderful Yamaha sound touched. click wonderful 'bell' sound won't affected. Moreover STSPEECH other utility produce digital sound effects Yamaha Cchip. Development: Paula developed using compiler {Assembler. 'real MODplayer', replay routine based 'Protracker/ E2.1B Player' Amiga Freelancers.: Thanx help...: helpful people were: Amiga documentation, D.O.C. Replay Routine Fridolin Protracker Replay Routine, Georges Kesseler tester optimization ideas, repeat- killer Christian Limpach: tester ST-Sound driver! ModPlay Interface MP.PRG simple utility which gives possibility launch modules command shell. simply sends MP_START message Paula. doesn't =evaluate wildcards aware method large command Ylines (link 'PCVSTART.O' compiling ideal 7with MintShel Mupfel. install application '*.MOD'-files standard DeskTop listen modules double clicking them, provided PAULA instal accessory! example programming style simple straightforward. MP.TTP public domain. CHECKMOD repair corrupted Eventually Paula refuse module comment 'Corrupted MODfile'. qthat CHECKMOD check maybe repair module question. "Simply start CHECKMOD module test. Under 2.06/3.06 module's CHECKMOD icon. Checkmod module control internal structures. /plays instruments reports error. These Corrupted Pattern List: Sorry, module cannot repaired. Short Sample: sample short. affects sample ;difference isn't Checkmod probably successful. Paula tolerates Ulacking bytes. Superfluous MODfile: problem module simply ggarbage appended. Checkmod because Paula tolerates bytes garbage. After running Checkmod 'Save Module Press <Return> leave, enter single module under current name. enter module using another name. Bibliography Jankowski Rabich Reschke Atari Profibuch ST/STE/TT2 Sybex Verlag 3-88745-888-5 Amiga Hardware Reference Manual4 Addison Wesley 0-201-18157-6 Thomsen Digitale Audiotechnik Franzis Verlag 3-7723-7151-5 Direkte Digitale Synthese Elektor @257, 1992, s.52ff Ulrich Michels Atlas Musik Akustik Wellenlehre Tonparameter Deutscher Taschenbuch Verlag 3-423-03022-4 Registration PAULA, Version register. oFirst, name: Street: City: comments, ideas reports (please about hardware problems player, helps lot): Table contents, Shareware Registration procedure Paula? Paula? began... System requirements Installation User's Guide control SampleFreq Player Sound Setup CPU-Load display Position General instructions Setup-Page dialog dialog: Packed modules! Error messages informations really chapter: LIMITATIONS! Internals ModPlay Interface CHECKMOD repair corrupted Bibliography Registration Table contents ffff` ffff` f<><l `|<<~ |~~>~ QUUUUE UUUUTU QUTUQQ DDD@DDDP PAUL_RSC.IMG#MAI %abtastfrequenzen amiga approximativly atari sungswechsel buggy cache chameleon chars checkmod chipregistern chirping christian clears commandline complications crashing dialog domain downloaded dudelange fastram fellerich fidonet formats freelancers freeware gemini henlastiger ignited informative internet kontaktadresse landmark legible limpach magix mailboxen megaste mintshel modfilename modfiles modplay modplayer modplayers modules multiplay multitos mupfel newer noisetracker norton originalsamples originate papyrus pascal paula paulas player plays project protracker prozessorbelastung random rechnern registrierdaten releases repairs repeat replay replayroutine resets return sample samplefreq schwartz selectric setup shannon shortcut soundchip soundhardware soundtracker speeeeed thanx henver nderung utility versender yamaha zweier